home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / diskmags / 0022-3.564 / dmg-3447 / text / at_once.txt < prev    next >
Text File  |  1991-10-09  |  38KB  |  914 lines

  1.  
  2.  
  3. README.GBR  for ATonce-Software version 3.0 - October 1990
  4.  
  5.  
  6. =============================================================================
  7. THE INFORMATION IN THIS FILE MUST BE READ CAREFULLY BEFORE THE AT-EMULATOR
  8. IS PUT INTO OPERATION FOR THE FIRST TIME 
  9. =============================================================================
  10.  
  11. This file contains the following information:
  12.  
  13. 1.   Contents of the ATonce System Disk
  14. 2.   The ATonce Installation Program INSTALL.PRG
  15. 3.   The Utility Programs CGA, MDA, V400, INVERS
  16. 4.   The Utility Programs SSCR and HSCR
  17. 5.   The Utility Programs VHIGH and VLOW
  18. 6.   Special key-combinations and their function 
  19. 7.   ATonce and MicroSoft WINDOWS 3.0
  20. 8.   The DOS DMA-Interface
  21. 9.   Speed-Bridge and ATonce
  22. 10.  proVME HyperCache and ATonce
  23. 11.  ATonce and Autoswitch Overscan
  24. 12.  The Multi-Atari-Manager "HyperSwitch"
  25. 13.  Trouble Shooting
  26.  
  27.  
  28.  
  29.  
  30.  
  31. 1. The system disk contains the following files and folders:
  32. ------------------------------------------------------------
  33.  
  34. Root-directory:
  35.  
  36. ATONCE.PRG     -    AT-Emulation program
  37.  
  38. INSTALL.PRG    -    Installation program for ATonce.  (ATONCE.PRG must be
  39.                     in the same directory!)
  40. INSTGER.RSC    -    Help file for INSTALL.PRG  (German)
  41. INSTGBR.RSC    -    ----"---- (English)
  42.  
  43. README.GER     -    this file (German)
  44. README.GBR     -    ----"---- (English)
  45.  
  46.  
  47. UPDATE.GER     -    About the installation of a software upgrade (German)
  48. UPDATE.GBR     -    ---"--- (English)
  49.  
  50.  
  51. Folder LASER:
  52.  
  53. PDRV_DB.OVR    -    Overlay for laser printer SLM804 see LASER.GBR
  54. PDRV_FX.OVR    -    Overlay for laser printer SLM804 see LASER.GBR
  55. LASER.GER      -    Information about the use of the laser printer 
  56.                     SLM804  (German)
  57. LASER.GBR      -    ---"--  (English)                  
  58.  
  59.  
  60. Folder TOOLS:
  61.  
  62. HDT.SYS        -    Device driver for hard disk partitions
  63. EMM.SYS        -    Expanded Memory Emulator (EMS 1.0)
  64. CONFIG.SYS     -    Example for a MSDOS configuration file
  65.  
  66. CGA.EXE        -    switches to CGA Video Emulation 
  67. MDA.EXE        -    switches to Hercules Emulation (SM124 only)
  68. V400.EXE       -    switches to Olivetti/T3100 Emulation (SM124 only)
  69. INVERS.EXE     -    switches the monitor from normal- to inverted display 
  70.                     and vv. (SM124 only)
  71. VHIGH.EXE      -    switches on long VBL pulse
  72. VLOW.EXE       -    switches on short VBL pulse 
  73.  
  74. ACSI.H         -    Includefile for the DOS DMA-Interface
  75. DEMO.ASM       -    small demo program for the use of the DMA-Interface
  76. DEMO.EXE       -    executable program 
  77.  
  78. GEMDOS.EXE     -    leave the AT-Emualtor - back to TOS-operation
  79.  
  80. HCON.EXE       -    enable HyperCache
  81. HCOFF.EXE      -    disable HyperCache
  82.  
  83. SSCR.EXE       -    switches on SoftScroll 
  84. HSCR.EXE       -    switches on HardScroll 
  85.  
  86. CLICK.EXE      -    switch keyclick on/off
  87.  
  88.  
  89. Folder HYPERSWI.TCH:
  90.  
  91. SWITCH.ACC     -    Accessory for HyperSwitch
  92. SWITCH.RSC     -    Help file for SWITCH.ACC
  93. HSWITCH.OVR    -    Help file for SWITCH.ACC
  94.  
  95.  
  96.  
  97.  
  98.  
  99. 2.  The ATonce Installation Program INSTALL.PRG
  100. -----------------------------------------------
  101.           
  102. This  Program  is a GEM application and makes it very easy to  set 
  103. all  the important operating parameters of the AT-Emulator. After 
  104. the start-up the following main menu appears:
  105.  
  106.  
  107.      DESK      File      Option   Country
  108.      
  109. as sub-menu you will find:
  110.  
  111.      DESK      File      Option              Setting the
  112.                Quit      Keyboard ---------- Keyboard Parameter
  113.                 !        Floppy ------------ Floppy Disk Parameter
  114.                 !        Harddisk  --------- Allocation of the TOS Partitions
  115.                 !        Mermory/Mouse ----- Extended/Expanded Memory/Mouse
  116.                 !        Graphic Emul. ----- Graphic Parameter
  117.                 !        Color  40x25  ----- Color Selection (SC1224 only)
  118.                 !        Color 80x25 ------- -----------"------------
  119.                 !        Color Graphic ----- -----------"------------
  120.                 !                             
  121.                 +------------------------------- Quit the installation
  122.                                                  program
  123.  
  124. (1)  Keyboard
  125.      - Choose between German and ASCII keyboard
  126.      - Set the key repeat rate
  127.      - Set the keyboard response delay 
  128.      
  129. (2)  Floppy
  130.      - Allocation of the physically existing drives to the DOS drives 
  131.        A and B.
  132.        
  133.      - Setting of the step rate of a possibly existing external 5.25" 
  134.        floppy drive (please note that some 80 track drives can be 
  135.        switched  to 40 track mode,  but that in this case the step  rate 
  136.        must be reduced (e.g. to 12 msec).
  137.        
  138.      - If  this  possibly existing external 5.25" drive is  a  40 track
  139.        drive this must also be set, as otherwise the emulator bios 
  140.        assumes that an 80 track drive is connected up and it will 
  141.        therefore create double steps when 360kB floppy disks are used.
  142.        
  143.      - With the box "HD" you can decide whether you want to use High Density
  144.        Floppy drives - 3.5" 1.44MB  or  5.25" 1.2MB.
  145.     
  146.  
  147. (3)  Hard Disk
  148.      - Free allocation of up to 24 TOS partitions to DOS  drives. 
  149.        The following points must be taken into consideration:
  150.        
  151.        a.) DOS can only be booted from the DOS-drive A or C.
  152.        
  153.        b.) Only TOS partitions with a maximum of 512 Bytes/Sector will 
  154.            be accepted.
  155.        
  156.        c.) It is your own responsibility that each TOS partition is 
  157.            assigned to one single (!) DOS drive. 
  158.        
  159.        d.) If you want the system to boot from the DOS drive  C, then
  160.            this drive must be formatted under DOS with 
  161.            
  162.            FORMAT C:/S
  163.            
  164.            This process will delete all data on the relevant TOS
  165.            partition.
  166.     
  167.        e.) Never use FDISK or similar programs. 
  168.      
  169.        f.) The DOS drives E,F etc. will only stand by if you declared
  170.            the device driver HDT.SYS in the MSDOS configuration file
  171.            CONFIG.SYS before.  Simply add the command:
  172.            
  173.            DEVICE=HDT.SYS
  174.            
  175.            Naturally HDT.SYS must be copied into the DOS boot drive before. 
  176.            
  177.            (If  there  are any other device driver declaration before
  178.            this command in CONFIG.SYS - e.g. RAMDisk etc. - then the 
  179.            additional DOS drives will only apprear from a higher drive 
  180.            label on.
  181.            
  182.      - You can choose between three different boot modes:
  183.      
  184.        a.) Floppyboot: Here the operating system is always booted from 
  185.                        floppy disk. The system will ask you to insert
  186.                        a DOS boot disk. 
  187.                        
  188.        b.) Harddiskboot: The operating system boots from the DOS drive
  189.                          C without any attempts of the system to boot from
  190.                          a floppy before. WARNING: This mode should only
  191.                          be selected if you can indeed boot from drive C.
  192.                          
  193.        c.) Floppy/Harddiskboot: The system will first try to boot from 
  194.                                 drive A. If this is not possible it will 
  195.                                 try drive C.
  196.                                 
  197.        Mode b.) has the advantage that the boot process is rather fast 
  198.        because the system does not even try to boot from the floppy disk
  199.        drive.
  200.        
  201.        Mode c.) equals the boot behaviour of a PC/AT compatible computer.
  202.        
  203.      - If you solely want to use TOS partitiones of the GEM  type, then
  204.        this can also be selected.
  205.        
  206.      - Further information about the allocation of TOS partitions
  207.        to DOS drives:
  208.        
  209.        In order to be able to always map the same TOS partitionen 
  210.        to the corresponding DOS drives we chose the proceedure of the  
  211.        direct physical allocation, this means that not the logical 
  212.        but the physical TOS partitions will be allocated. Here is one
  213.        example to make this clearer:
  214.        
  215.  
  216.        +--------------+       +---------------+        +---------------+
  217.        !    Atari     !-------!  Hard Disk 1  !--------!  Hard Disk 2  !
  218.        +--------------+       +---------------+        +---------------+
  219.                                  Adapter 0                Adapter 1
  220.                                  2 Partitions             3 Partitons
  221.                                  
  222.  
  223.         DOS drive    TOS partition/adapter       Meaning  
  224.        
  225.          C                  1/0              2nd partition on hard disk 1
  226.          D                  2/1              3rd partition on hard disk 2
  227.          E                  0/0              1st partition on hard disk 1
  228.          F                  1/1              2nd partition on hard disk 2
  229.          
  230.  
  231.        The partitions on each hard disk are numbered from 0 to N-1.
  232.        
  233.        This allocation proceedure has the great advantage that the DOS
  234.        drives are always allocated to the correct TOS partitions, even  
  235.        if for example another hard disk is connected to the system 
  236.        (assuming that the adapter numbers were not changed !).
  237.        
  238.      - In the column MD you can decide whether the corresponding partition
  239.        is TOS compatible or not. If you want to use "DR DOS" or if you want
  240.        to have under MSDOS partitions that are larger than 32MB you have to
  241.        click on the "C" so that it is light gray. Partitions that are not
  242.        TOS compatible must be prepared with FDISK and FORMAT under DOS.      
  243.  
  244.  
  245. (4)  Memory/Mouse
  246.      - If your Atari contains more than 1MB memory the additional memory
  247.        (above 1MB) can be used as extended memory. From this extended 
  248.        memory in turn a part can be reserved for the expanded memory 
  249.        emulator EMM.SYS.
  250.        
  251.        Example:  Mega ST4 - 3072 kB additional memory
  252.                  e.g. 2000 kB Extended Memory
  253.                       1072 kB Expanded Memory
  254.                         
  255.        In order to be able to use the expanded memory the expanded 
  256.        memory emulator EMM.SYS must be loaded. Just enter the command 
  257.        
  258.        DEVICE=EMM.SYS
  259.        
  260.        into the MSDOS configuration file CONFIG.SYS. Naturally EMM.SYS 
  261.        must be copied onto the DOS boot drive before.
  262.  
  263.      - The Atari Mouse can be used as Microsoft Mouse under DOS. You can
  264.        choose whether COM1 or COM2 (or none) is used for the emulation.
  265.        Then the serial interface is always on the corresponding other 
  266.        COM port.
  267.        
  268.        In order to be able to use the Atari Mouse as Microsoft Mouse  
  269.        a mouse driver must be loaded. Any Microsoft compatible driver 
  270.        can be used.  e.g. enter the command
  271.        
  272.        DEVICE=MOUSE.SYS
  273.        
  274.        into the MSDOS configuration file CONFIG.SYS. Naturally MOUSE.SYS 
  275.        must be copied onto the DOS boot drive before. 
  276.        (The mouse driver is not part of the delivery of vortex ATonce!)
  277.        
  278. (5)  Graphic Emulation
  279.      The user must always distinguish between the Atari monochrome 
  280.      (SM124) and the Atari color (SC1224) monitor.
  281.      
  282.      - on the color monitor only CGA emulation is possible. 
  283.        
  284.      - on the monochrome monitor you can choose between several emulations.
  285.        In addition you can choose between inverted and normal display. 
  286.        The low- and high intensity text displays of the  AT  are emulated
  287.        through two different fonts, the low and the high font.
  288.        You have the choice between running the emulation in this way (L & H)
  289.        or using only one of the two fonts for the low and high intensity
  290.        text displays. 
  291.        
  292.      - On the monochrome as well as on the color monitor you have the
  293.        possibility to switch the attribute <BLINKING> on or of.  As the
  294.        video emulation is fully software controlled it is  sensible to 
  295.        switch this attribute off if programs are used which display the 
  296.        complete contents of the screen blinkingly.
  297.        
  298.      - If the Atari has a Blitter chip it can be used under DOS to 
  299.        accelerate the graphic video output.
  300.        
  301.  
  302. (6)  Color Assignment 
  303.      This option is only available on the Atari color monitor SC1224.
  304.      
  305.  
  306.  
  307. Through  the  sub-menu  Country ATonce can  be  switched  to  the 
  308. correct language.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315. 3. The Utility Programs CGA, MDA, V400, INVERS
  316. ----------------------------------------------
  317.  
  318. It is often  useful to be able to change the video emulation without
  319. having to leave DOS before (in order to configure ATonce anew). The
  320. settings determined in these programs are RESET-proof, which means that
  321. even after pressing the reset-key or ALT-CTRL-DEL they remain valid.
  322. CGA:         Switch to CGA video emulation
  323. V400:        Switch to Olivetti/Toshiba video emulation
  324. MDA:         Switch to Hercules video emulation
  325. INVERS:      Switch to invers video - also possible by pressing 
  326.              simultaneous the Left-Shift and the Undo-Key.
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. 4. The Utility Programs SSCR and HSCR
  335. ------------------------------------- 
  336.  
  337.                    
  338. The emulation of the PC text modes is rather time consuming.  Here, too,
  339. we have tried our best to squeeze everything possible out of the Atari. In 
  340. order to give you several possibilities here we have implemented two 
  341. scroll modes.
  342.  
  343. - the SoftScroll, which performs a regular and continual Scroll, but takes
  344.   a little more computing time.
  345.   
  346. and
  347.  
  348. - the HardScroll, which scrolls a little "jumpier", but which is therefore
  349.   considerably faster.
  350.   
  351. The default setting after the start-up of ATonce is SoftScroll. The
  352. selected setting is reset-proof.
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359. 5. The Utility Programs VHIGH and VLOW
  360. --------------------------------------                  
  361.  
  362. In order to guaranty a flicker-free screen display some programs synchronize
  363. their accesses to the video RAM to the vertical blank of the video controller
  364. (VBL). They may be waiting here for a certain length of the VBL impulse.
  365. As the video part is emulated by the ATonce through software it is not
  366. possible to create a one-to-one copy of the VBL pulse. The default setting
  367. is VLOW, meaning a short VBL impulse. If a program "hangs" after the start
  368. up it might be that it is waiting in an endless loop  for a long VBL impulse.
  369. In this case reset ATonce and start the program VHIGH before restarting
  370. the other program. (One program where this is the case is e.g. the Editor
  371. from Norton Utilities NE.COM).
  372. VLOW and VHIGH are not reset-proof. After the reset the video part is 
  373. always in a state that equals VLOW.
  374.  
  375.  
  376.  
  377.                     
  378.  
  379. 6. Special key-combinations and their function
  380. ----------------------------------------------
  381.  
  382. Help                       - Move Hercules Graphic Screen to the left.
  383. Undo                       - Move Hercules Graphic Screen to the right.
  384.  
  385. Left Shift + Help          - Keyclick on/off.
  386.  
  387. Left Shift + Undo          - Inverted video on/off (only SM124).
  388.  
  389. Left Shift + Alternate +
  390. Undo                       - Switch back to GEM-DOS (same function as
  391.                              GEMDOS.EXE).
  392.  
  393. Alternate + help           - If HyperSwitch is active you can switch with
  394.                              this key-combination back to the "last" ST
  395.                              computer.
  396.                              
  397. Left Shift + "*"
  398. in the numeric block       - If the SLM804 is active this key-combination
  399.                              prints a hardcopy of the screen.
  400.                              
  401.  
  402.  
  403.  
  404.  
  405. 7. ATonce and MicroSoft Windows 3.0
  406. -----------------------------------
  407.  
  408. Since ATonce is a true AT-Emulator the so called Protected Mode is fully
  409. supported (this mode is also known as Virtual Mode). Windows 3.0 is one
  410. of the few programs which allows you to use the extended memory of an
  411. AT machine as program memory.  
  412.  
  413. Advices for the installation of Windows 3.0:
  414.  
  415. - You need a ST with more than 1MB RAM (e.g. Mega ST4) to run Windows 3.0
  416.   in Protected Mode.
  417.   
  418. - Install with INSTALL.PRG the size of the extended memory you want to use.
  419.   e.g. 3072KB when using a Mega ST4 computer.
  420.   
  421. - Insert in the DOS configuration file CONFIG.SYS the HIMEM.SYS driver which
  422.   comes with Windows 3.0 (version 2.60 or larger).
  423.   DEVICE=HIMEM.SYS
  424.   You can use EDLIN to insert this line.
  425.   
  426. - If you use the SM124 monitor choose the "Olivetti/AT&T monochrom .."
  427.   adapter in the Windows 3.0 setup program.
  428.   
  429. - Before you start Windows 3.0 you must start V400 or you have to install
  430.   the Olivetti mode with INSTALL.PRG as the ATonce startup video emulation.
  431.   
  432. - WIN<RETURN> loads Windows 3.0 in the Protected Mode, WIN /R<RETURN> 
  433.   loads Windows 3.0 in the Real Mode.
  434.   
  435.  
  436.  
  437.  
  438.  
  439. 8. The DOS DMA-Interface
  440. ------------------------
  441.                      
  442. Under DOS there is a direct interface to the Atari DMA channel (ACSI) 
  443. available.  This  interface can for example be used to  integrate your
  444. own hard disk driver. The definition of the interface can be looked up 
  445. in the file ACSI.H, the correct use is explained in the program DEMO.ASM.
  446.  
  447.  
  448.  
  449.  
  450.  
  451. 9. Speed-Bridge and ATonce
  452. --------------------------
  453.                     
  454. ATonce does not work together with the Speed-Bridge for the PC-Speed. For 
  455. the installation without soldering into the MEGA ST and the STE we have
  456. developed two plug-in adapters for the ATonce.
  457.  
  458.  
  459.  
  460.  
  461.  
  462. 10. proVME HyperCache and ATonce
  463. --------------------------------
  464.               
  465. ATonce should also run together with the HyperCache of proVME without any
  466. problems. Please note the following points during the installation:
  467.  
  468.  
  469. (1) Another 64pin socket must be soldered onto the ATonce:
  470.     Side view onto the ATonce PCB:
  471.     
  472.  
  473.                                     Side with components
  474.          =========  <-- Socket      !
  475.          ! ! ! ! !                  ! 
  476.     -->  . . . . . . . . . . .      v
  477.     !   ===================================
  478.     !    ! ! ! ! ! ! ! ! ! ! !    <---- Pins
  479.     !
  480.     !
  481.     solder here
  482.     
  483.  
  484.     The soldering must be done extremely carefully. Great care must be
  485.     taken that there are no unwanted "bridges" or shorts between two
  486.     pins.
  487.     
  488.     This extended ATonce PCB is plugged into the socket on the ST 
  489.     motherboard. (This socket was build in for the installation with
  490.     HyperCache instead of the 68000 CPU!)
  491.     
  492. (3) Now plug the HyperCache into the socket which was soldered onto
  493.     the ATonce as  discribed in (1).
  494.     
  495. (4) Ready. 
  496.  
  497. Note:  We found that in some STs there may be a conflict between the Hyper-
  498.        Cache and the Blitter. These problems have nothing to do with the
  499.        ATonce!  We recommend to switch off the Blitter whenever you want to
  500.        work with HyperCache.
  501.            
  502. IMPORTANT: ATONCE MUST NOT BE PLUGGED INTO THE 16 MHZ 68000 CPU OF THE
  503.            HYPERCACHE !!
  504.          
  505. You will find two programs in the folder TOOLS which enable you to switch
  506. the HyperCache on (HCON.EXE) or off (HCOFF.EXE) under DOS.
  507.     
  508.  
  509.  
  510.  
  511.  
  512. 11. ATonce and Autoswitch Overscan
  513. ----------------------------------
  514.                     
  515. On the monochrome monitor SM124 during the Hercules graphic emulation
  516. ATonce also supports the AutoSwitch-OverScan graphic expansion of 
  517. OverScan GbR. However, this must already be active before ATonce is 
  518. started.  Under DOS ATonce switches OverScan on and off automatically.
  519.  
  520. IMPORTANT: PLEASE NOTE THAT IN CASE YOU ARE WORKING WITH THE ATARI LASER
  521.            PRINTER SLM804  UNDER DOS THE HARDCOPY-FUNCTION WILL NOT BE
  522.            WORKING CORRECTLY UNDER THE HERCULES GRAPHIC MODE. THIS IS
  523.            BECAUSE THE LASER PRINTER DRIVER (NO MATTER IF IT IS SDUMP.PRG
  524.            OR SLM804.ACC) WILL NOT SUPPORT  THE OVERSCAN MODE.
  525.  
  526. IF YOU USE HYPERSWITCH OVERSCAN MUST NOT BE ACTIVE !
  527.  
  528.  
  529.  
  530.  
  531.  
  532. 12. The vortex Multi-Atari-Manager "HyperSwitch"
  533. ------------------------------------------------
  534.  
  535. HyperSwitch is a useful utility if you wish to work fast and practically
  536. simultanously with several operating systems on an ST computer.  With the
  537. aid of HyperSwitch up to 8 "logical" ST computers can be started on one
  538. "physically" existing Atari ST.  Through an accessory in GEMDOS and a 
  539. special key combination in MSDOS you can switch quickly between one 
  540. logical Atari, the operating system running there and the application
  541. running in this operating system, and another logical Atari, the
  542. operating system and the application running there.
  543.  
  544. The minimum precondition for the use of HyperSwitch is a Atari ST
  545. computer (with vortex ATonce installed) with at least 512KB RAM (in this
  546. case in addition to the Atari you need a hard disk with 20MB or more). 
  547. If the total RAM-size of all logical ST computers is larger than the
  548. physically available RAM the status data of the logical STs are swapped to
  549. the hard disk. The switch-time depends on the RAM size and the storage 
  550. capacity of the physical ST computer as well as the number and RAM size of
  551. the logical STs and is normally not longer than a few seconds.
  552.  
  553. The following example explains the functioning of vortex HyperSwitch:
  554. You have decided to install 3 logical STs on your physical ST computer.
  555. On the first ST you are running WORD5 (under MSDOS4.01) where you edit your
  556. text. On the second ST you are using the text-editor TEMPUS (under GEMDOS) 
  557. and finally on the third ST you are using the MicroSoft Flightsimulator
  558. (also under MSDIS4.01). 
  559. With a special key-combination you can switch now directly from the position
  560. in the text that you edit with WORD 5.0 to the position where you left TEMPUS.
  561. If you click on the HyperSwitch accessory you can choose now whether to
  562. switch back to WORD 5.0 or to the Flightsimulator. In both cases you will
  563. find the logical ST in exactly the same condition when you left it.
  564. ... your Cessna 182 is still airborne.
  565.  
  566.  
  567. Common advices:
  568.  
  569. (1) HyperSwitch is not a Multitasking Operating system. An logical ST
  570. which is switched into the backround is "frozen" and not running. As soon
  571. as you switch it back it will be "defrosted".
  572.  
  573. (2) The maximum RAM size of a logical ST computer equals the RAM size of
  574. the physical ST minus 40KB for HyperSwitch.
  575.  
  576. (3) One logical ST "knows" nothing about the other logical ST(s).
  577. Therefore it is strictly forbidden to access one file from several logical
  578. STs, especially when this file is opened or accessed by a write operation.
  579. If you are not careful here you will destroy data !
  580. This means for example that it is not allowed to edit the same text
  581. under MSDOS 4.01 / WORD5.0 and under GEMDOS / TEMPUS.
  582. We recommend the use of different hard disk partitions for the different 
  583. logical ST computers.
  584. If you switch back to a logical ST which runs under GEMDOS, you should press
  585. the ESC-Key to force a media-change.
  586.  
  587.  
  588. (4) In the following text we distinguish three conditions in which a logical
  589. ST computer can be:
  590.  
  591. Installed:       The RAM size and the Swap mechanism are installed. The 
  592.                  corresponding line in the accessory is printed bold.
  593.  
  594. Initialized:     The line in the accessory is printed bold and has a little
  595.                  hook. This means that this logical ST is now available and 
  596.                  can be activated.
  597.  
  598. Active:          The logical ST that runs at this moment. In the 
  599.                  HyperSwitch accessory the line of this logical ST is
  600.                  printed inverted and in the box "Active Atari" you will
  601.                  find the number of this logial ST.      
  602.  
  603.  
  604.  
  605.  
  606. HyperSwitch consists of the following three files:
  607.  
  608. SWITCH.ACC           SWITCH.RSC           HSWITCH.OVR
  609.  
  610. To use HyperSwitch all three files have to be copied from the system disk
  611. into the root directory of GEMDOS partition C. After the next reset
  612. (initialized through a key-combination or through pressing the reset-button)
  613. the HyperSwitch accessory is available. It will automatically perform 
  614. another reset to activate the first logical ST computer.
  615.  
  616. If you click on the HyperSwitch accessory you will find several information:
  617.  
  618. Active Atari:      The number of the logical ST that is running now
  619.                    (that is active).
  620.  
  621. Atari total:       Amount of installed logical ST computers.
  622.  
  623. Memory free:       Remaining available RAM for further logical STs.
  624.  
  625. Memory total:      Total RAM which is available for HyperSwitch on this 
  626.                    physical ST computer.
  627.  
  628.                    
  629. A table shows the logical STs. This table contains the following information:
  630.  
  631. Atari:             Number of a logical ST. If this line is printed bold the
  632.                    corresponding logical ST is installed.
  633.                    
  634. Size [KB]:         RAM size of a logical ST. The maximum size is shown in
  635.                    "Memory total".
  636.                    
  637. Swap:              "Off": status data are not swapped to the hard disk when
  638.                    switching from one logical ST to another.
  639.                    "On": when switching from one logical ST to another the
  640.                    status data are swapped to the hard disk. The filename and
  641.                    the partition where the status data are swapped to can
  642.                    be selected in the INSTALL menu of the HyperSwitch
  643.                    accessory. This menu can be accessed by clicking on the
  644.                    INSTALL-button.
  645.                    
  646. Init:              The little hook shows that the already installed 
  647.                    logical ST is initialized and ready for operation.
  648.                    Before you can initialize the next logical ST it has
  649.                    to be installed (by pressing the INSTALL-button and
  650.                    selecting the various parameters in this menu).
  651.                    After this installation the line of this logical ST 
  652.                    can be clicked on. The ST computer will now make a 
  653.                    reset. If you click on the HyperSwitch accessory this
  654.                    logical ST will also be displayed with the little hook. 
  655.                    
  656. Application:       "-" :      This logical ST runs under GEMDOS.
  657.                    "ATONCE" : This logical ST runs under ATonce/MSDOS.
  658.                    
  659.  
  660. If you click on the QUIT-button the accessory window will be closed.
  661.  
  662. If you click on the COLDBOOT-button the physical ST computer is reset.
  663. IMPORTANT:  the contents of all logical STs that are initialized at this
  664. moment will be lost.
  665.  
  666.  
  667. If you click on the INSTALL-button in the main window of the HyperSwitch 
  668. accessory another window comes up in which you can install the logical STs.
  669. This meue offers several possibilities:
  670. To select a logical ST simply click on the corresponding line.  An arrow
  671. will appear on the left side.
  672. To install the RAM size you have to click on the "<     >" or "<<    >>" 
  673. buttons. The value in the "Free" field shows the RAM available for other
  674. logical STs.
  675.  
  676. If you click on the Swap-button you can decide whether the status data is
  677. swapped to the hard disk or not. If you set swap to "on" you can give the 
  678. swapfile a name (or use the default name) and you can choose the partition
  679. to which it will be swapped to.
  680. A swapfile for a logical ST with 4MB RAM is 4MB in size ! 
  681. You must ensure that there is enough space on your hard disk.
  682. If you created a configuration where you installed logical STs which use
  683. the swap mechanism and which do not use this mechanism, HyperSwitch needs
  684. a special temporary file (SWAP .TMP). You can also decide in which partition
  685. of your hard disk this file will be stored. 
  686. Swapfiles are always stored in the root-directory of the partition selected.
  687. If you now click on the INSTALL-button your configuration will be saved. 
  688. In addition HyperSwitch automtically creates the swapfiles and the SWAP.TMP
  689. file. Afterwards HyperSwitch resets the ST computer.
  690. IMPORTANT:  the contents of all logical STs that are initialized at this
  691. moment will be lost.
  692. If you click on the DEFAULT-button HyperSwitch will display two logiacl STs,
  693. each with 50% of the memory in total available, and no swapfiles.
  694. If you click on the SWITCH-button you will come back to the main window of
  695. the HyperSwitch accessory.
  696. The TEMP-INST-button has a very special function. 
  697. With this button you can load swapfiles of "older" logical STs.
  698. This is a very powerful feature which enables you to "defrost" (bring 
  699. back to life) any logical ST you stored in a swapfile at any time in the
  700. past. As soon it is loaded you will have the same logical ST with the same 
  701. program running that you had "froze" at an earlier date.
  702. To use the TEMP-INST (temporary installation) button first select a logical
  703. ST. Then click on the TEMP-INST-button and type in the filename and the 
  704. partition of the swapfile you want to load. You do not need to alter the RAM
  705. size of the logical ST computer. 
  706.  
  707.  
  708. To switch from one logical ST to another HyperSwitch offers two
  709. possibilities:
  710.  
  711. Under GEMDOS:       through the HyperSwitch accessory. To activate another
  712.                     logical ST simply click on the bold printed line with 
  713.                     a hook.
  714.  
  715. Under ATonce/MSDOS: Press the Alternate and the Help key simultanously.
  716.                     This will take you back to the previous logical ST.
  717.  
  718.  
  719.  
  720. Further advices:
  721.  
  722. When leaving our factory the parameters of HyperSwitch have the following 
  723. values: two logical STs, each with a RAM size of approx. 500KB, no Swap
  724. files, first logical ST initialized (with hook) and active.
  725.  
  726. If you install on a Mega ST4   8 logical ST computers you need 
  727. 32MB (!) capacity for the swapfiles. 
  728.  
  729. If you rename SWITCH.ACC to SWITCH.PRG you can use HyperSwitch as a normal
  730. GEM-application. If you want to copy HyperSwitch into the AUTO-folder
  731. it is sensible that SWITCH.PRG be the first file in this folder. To do this
  732. first save the contents of the AUTO-folder, and then erase all files in the
  733. AUTO-folder. Afterwards copy SWITCH.PRG as the first (!) file into the
  734. AUTO-folder and then all other files you have saved previously saved.
  735.  
  736. If you choose a logical ST too small (not enough RAM) programs may not run
  737. or prompt that they need more RAM.
  738. If HyperSwitch brings an error message <<ERROR 08>> it has not enough RAM 
  739. to work properly. This is not a dead-lock. You have to erase the HSWITCH.OVR
  740. file and use the one which is on your system disk. Naturally all settings
  741. you made in HyperSwitch are lost.
  742.  
  743.  
  744.  
  745.  
  746.  
  747. 13. Trouble-Shooting
  748. --------------------
  749.  
  750. In this last chapter we want to give some hints what you can do
  751. if problems occur.
  752.  
  753.  
  754. (1) The installation of ATonce in an ST1040FM where the CPU sits under
  755. the floppy drive.
  756.  
  757. We have noticed that there are several version of this special ST1040.
  758. Sometimes Atari used very thick floppy drives which also have a
  759. shield at the bottom.
  760. We found two ways how to fit the ATonce into the ST properly:
  761.  
  762. o   Take off the shield of the floppy drive. It is still tight, but there
  763.     should be enough room for the ATonce now.
  764.     
  765. o   De-solder the 68000 CPU and put a socket in the motherboard. 
  766.     Solder another socket on top of ATonce (similar to when you want to
  767.     use HyperCache). Plug ATonce into the socket on the motherboard and
  768.     then the 68000 CPU into the socket of the ATonce.
  769.     
  770.  
  771.  
  772. The problems we describe now have their root in the ST computer. We know
  773. that it is very simple to say (especially for dealers) that the reason for
  774. any problem is ATonce !
  775. This is not true. The ST is a brilliantly designed machine but sometimes
  776. manufactured very poorly. Unfortunately especially at critical points you
  777. will often find chips from Korea or Taiwan which normally do anything
  778. but fullfilling the specifications !
  779.  
  780.  
  781. (2) The Mega ST sometimes does not start. The screen remains dark.
  782. If your Mega ST has the little PCB which was soldered on top of the 68000 
  783. CPU (by the way the reason for this is a design error in one of the
  784. asics) this problem can occur. Solder a 40 Ohm resistor between Pin 12
  785. (68000 CPU/ATonce) and the first Pin of this little PCB. This means this
  786. Pin does not directly go to the 68000 CPU/ATonce but via the 40 Ohm resistor.
  787.  
  788. (3) The Mega ST hangs when testing the RAM or crashes without appearant
  789. reason. This problem mostly occurs with Mega ST2 computers. 
  790. You have to replace U33 and U36 (74LS373) with 74ALS373 from Texas
  791. Instruments or Motorola. Do not use chips from Goldstar or ST or SGS.
  792.  
  793. (4) Several hard disks and/or a SLM804 are connected to the Mega ST.
  794. You have problems with the SLM804 and with the hard disk(s).
  795. This problem occurs also without ATonce !
  796. Similar as described in (3) there is one chip of a taiwanese manufacturer
  797. that can cause problems. This chip is the DMA-Port-Controller. It is a 
  798. 40 Pin DIL IC and comes from "IMP" (C100-110-001). It has to be replaced
  799. by another version of the DMA-Port-Controller "CO25913-38". 
  800. Contact your dealer or Atari, they know about this problem.
  801.  
  802. (5) The ST does not start after a crash or only brings the 
  803. "POST MORTEM DUMP" message.
  804. Even when the ST computer is switched off the contents of the RAM-cells will
  805. remain for a fairly long time.
  806. When ATonce is loaded it takes over the reset of the ST 
  807. computer. This is the reason why sometimes, especially when the Emulator
  808. crashes, even when you switch the ST off you will receive a POST MORTEM
  809. DUMP or a dark screen. To avoid this effect simply wait 60 seconds befor
  810. switching on the ST, or press ESC when ATonce shows the POST MORTEM DUMP.
  811.  
  812. (6) Autoboot with hard disks from ATARI.
  813. The Autoboot mechanism of Atari manipulates the root-sector of the first
  814. partition (Icon C). If you assign this first partition to the logical DOS
  815. drive C and install MSDOS on DOS drive C you will loose the Autoboot-
  816. facility. To avoid this simply assign any other partition to the logical 
  817. DOS drive C.
  818.  
  819. (7) Mouse-Driver.
  820. Only use mouse-drivers that are fully compatible with the serial
  821. Microsoft Mouse. 
  822.  
  823. (8) The ATonce startup-Screen is not erased properly after DOS has booted.
  824. To solve this "problem" remove the ansi.sys driver in your CONFIG.SYS file.
  825.  
  826. (9) The Break-Key does not function under DOS.
  827. Insert in the CONFIG.SYS file "BREAK=ON".
  828.  
  829.  
  830.  
  831.  
  832. ========================================================================
  833.  
  834.  
  835. Your vortex Team                        October 1990
  836. ========================================================================               
  837.  
  838.  
  839. Operating the Atari Laser Printer SLM804 with the AT-Emulator:
  840. -------------------------------------------------------------
  841.          (ONLY ST COMPUTERS WITH MORE THAN 1MB MEMORY!)
  842.  
  843. With ATonce the Atari laser printer SLM804 can be used together with 
  844. the Atari Diablo driver DIAB630.PRG and the hardcopy program SDUMP.PRG 
  845. or the Epson FX80 compatible laser printer driver SLM804.ACC. 
  846. Precondition is that your ST computer has more than 1MB memory available. 
  847.  
  848. To install the laser printer proceed as follows: 
  849.  
  850. (1) Configure ATONCE.PRG for your needs with the setup program 
  851.     INSTALL.PRG.
  852.     
  853.     IMPORTANT: YOU  HAVE TO MAKE SURE THAT IN THE OPTION MEMORY/MOUSE 
  854.                THE TOTAL OF EXTENDED AND EXPANDED MEMORY IS ONLY SO 
  855.                LARGE THAT THERE IS ENOUGH MEMORY LEFT FOR THE LASER 
  856.                PROGRAMS.  DEPENDING ON HOW MANY FONTS YOU HAVE LOADED 
  857.                YOU SHOULD RESERVE APPROX. 300-700KB FOR THIS PURPOSE. 
  858.     
  859. (2) Diablo Driver:
  860.     --------------
  861.     Now install DIAB630.PRG with the programm SETUP630.PRG. 
  862.     IMPORTANT: SET THE OPTION MENU ON INTERNAL.
  863.     
  864.     Epson Driver:
  865.     -------------
  866.     Create the batch file SLM804.BAT as discribed in the 
  867.     instructions for printer driver. 
  868.     IMPORTANT: MAKE SURE THAT YOU RESERVE A LARGE ENOUGH BUFFER. 
  869.     
  870. Depending on whether you start the emulator through the AUTO-folder or
  871. directly by clicking on, please proceed as follows: 
  872.  
  873.  
  874. AUTO-Boot from Floppy or Hard Disk:
  875.          
  876. (3) Copy ATONCE.PRG into the AUTO-folder. 
  877.     All the following programs are copied into the Root directory:
  878.  
  879.     Diablo Driver:
  880.     --------------
  881.     PDRV_DB.OVR, DIAB630.PRG, SDUMP.PRG and all necessary font files.
  882.     
  883.  
  884.     Epson Driver:
  885.     -------------
  886.     PDRV_FX.OVR, SLM804.ACC, SLM804.BAT and all necessary font files,
  887.     e.g. ELITE.DRF.
  888.     
  889.  
  890. Start by clicking on directly:
  891.  
  892. (3) In this case the following files must be in the same directory 
  893.     as the driver:
  894.  
  895.     for Diablo Driver 
  896.       ATONCE.PRG, PDRV_DB.OVR, DIAB630.PRG, 
  897.       SDUMP.PRG and all necessary font files.
  898.       
  899.     or for Epson Driver
  900.       ATONCE.PRG, PDRV_FX.OVR, SLM804.ACC, SLM804.BAT and all necessary 
  901.       font files. 
  902.  
  903.  
  904. If the emulator is started now, assuming that everything was installed 
  905. correctly and/or the laser printer is connected up, the usual start messages 
  906. of the programs DIAB630.PRG and SDUMP.PRG or of SLM804.ACC should appear.
  907. Under DOS you have now the laser printer available on the parallel interface
  908. LPT1 (the internal centronics interface appears as LPT2).
  909.  
  910. If SDUMP.PRG or SLM804.ACC respectively were installed correctly you will
  911. now have under DOS through the key combination <PrtScr> (press the Shift-
  912. key and * in the numerical block at the same time) a hardcopy function which
  913. supports graphics available.
  914.